package com.gdust.lease.web.admin.custom.converter;

import com.gdust.lease.model.enums.BaseEnum;
import org.springframework.core.convert.converter.Converter;
import org.springframework.core.convert.converter.ConverterFactory;
import org.springframework.stereotype.Component;

/**
 * ClassName: StringToBaseEnumConverterFactory
 * Package: com.gdust.lease.web.admin.custom.converter
 * Description:类型转换类
 * 实现前端输入的1或者2，对应枚举中code属性（1或者2）到枚举对象实例ItemType.APARTMENT/ItemType.ROOM的类型转换
 * 解决：参数绑定发生参数转换异常问题
 *
 * @Author syun
 * @Create 2025/1/1 22:33
 * @Version 1.0
 */
@Component//组件注解，注册为bean
public class StringToBaseEnumConverterFactory implements ConverterFactory<String,BaseEnum> {

    /**
     * 获取从 String 类型到目标枚举类型的转换器
     *
     * `ConverterFactory<S, R>`:
     * - S：源类型（此处为 String）
     * - R：目标类型的父类（此处为 BaseEnum）
     *
     * @param targetType 目标枚举类型的 Class 对象
     * @return 转换器实例，用于将 String 转换为目标枚举类型
     * @param <T> 目标枚举类型，必须是 BaseEnum 的子类
     */
    @Override
    public <T extends BaseEnum> Converter<String, T> getConverter(Class<T> targetType) {
        return new Converter<String, T>() {
            /**
             * 将输入的字符串转换为目标枚举实例
             *
             * @param source 前端传递的字符串，通常是枚举的 `code` 值
             * @return 转换后的目标枚举实例
             * @throws IllegalArgumentException 如果字符串无法匹配任何枚举，则抛出异常
             */
            @Override
            public T convert(String source) {
                // 遍历所有枚举常量
                for(T enumConstant:targetType.getEnumConstants()){
                    // 比较枚举常量的 `code` 值是否与输入字符串匹配
                    if(enumConstant.getCode().equals(Integer.valueOf(source))){
                        return enumConstant;
                    }
                }
                //匹配不到则抛出异常
                throw new IllegalArgumentException("非法的枚举值:"+source);
            }
        };
    }
}
